автор перевода - Штрек - flash-club.ru	Предыдущая | Следующая | Оглавление

_accProps

Доступность

Flash Player 6.65.

Синтаксис

_accProps.propertyName
instanceName._accProps.propertyName

Параметры

propertyName Имя свойства доступности (см. следующее описание для допустимых имён).

instanceName Имя экземпляра объекта, такого как: мувиклип, кнопка, динамическое текстовое поле или поле ввода. При обращении к _accProps приложения, instanceName опускается.

Описание

Свойство; позволяет Вам динамически управлять настройками доступности для SWF файлов, мувиклипов, кнопок, динамических текстовых полей и полей ввода текста. Эти настройки изменяют соответствующие настройки, сделанные в панели Accessibility среды разработки. Чтобы обновлённые настройки вступили в силу, Вы должны вызвать Accessibility.updateProperties(). Для получения информации о панели Accessibility, смотрите "Панель Flash Accessibility" в Использовании Флэш.

Для определения, функционирует ли плэер в системе с поддержкой чтения экрана, используйте свойство System.capabilities.hasAccessibility.

Следующая таблица имеет список имён и типов данных каждого свойства _accProps, их эквивалент в настройках панели Accessibility, а также список объектов, к которым свойство может быть применено. Термин inverse logic означает, что свойство устанавливает инверсию относительно настроек панели Accessibility. Для примера, установка свойства silent в true , эквивалентно отключению опций Make Movie Accessible или Make Object Accessible.

*Для поля Shortcut, используйте имена вида - Control+A. Добавление клавиатурных сокращений в панели Accessibility не создаёт новых клавиатурных сокращений, а просто сообщает программе чтения экрана о существующих сокращениях. Для информации о назначении клавиатурных сокращений в объекте доступности, смотрите Key.addListener().

Для определения Tab index/индекса табуляции/, назначенных в панели Accessibility, используйте свойства Button.tabIndex, MovieClip.tabIndex, или TextField.tabIndex .

Динамических способов определения назначений Auto Label нет.

Для обращения к _accProps целого SWF файла, необходимо опустить параметр instanceName. Свойство _accProps должно быть объектом. Это означает, что если объект _accProps не существует, Вы должны создать его, как показано в следующем примере, до назначения ему свойств :

if ( _accProps == undefined ) {
  _accProps = new Object();
}
_accProps.name = "My SWF file";

Когда _accProps используется без параметра instanceName, изменения свойств, сделанные в _accProps относятся к целому SWF файлу. Например, следующий код устанавливает свойство доступности name для целого SWF файла в строку "Pet Store" и , после вызова Accessibility.updateProperties(), изменение вступает в силу :

_accProps.name = "Pet Store";
Accessibility.updateProperties();

Напротив, следующий код устанавливает свойство name для мувиклипа с именем price_mc в строку "Price" :

price_mc._accProps.name = "Price";
Accessibility.updateProperties();

Если Вы определяете несколько свойств доступности, делайте все определения перед вызовом метода Accessibility.updateProperties(), вместо того, чтобы вызывать этот метод после каждого определения, как показано в этом примере :

_accProps.name = "Pet Store";
animal_mc._accProps.name = "Animal";
animal_mc._accProps.Описание = "Cat, dog, fish, etc.";
price_mc._accProps.name = "Price";
price_mc._accProps.Описание = "Cost of a single item";
Accessibility.updateProperties(); 

Если Вы динамически не устанавливаете свойства доступности для документа или объекта, будут действовать значения, установленные в панели Accessibility.

После того, как Вы определили свойства доступности, возвратиться к установленным в Accessibility панели, Вы не сможете. Однако, Вы можете установить значения свойств, установленные по умолчанию (false для булевых значений ; пустые строки для строковых значений), удалив свойства объекта _accProps, как показано в следующем примере :

my_mc._accProps.silent = true; // определяем свойство
// строка кода, удаляющая my_mc._accProps.silent
delete my_mc._accProps.silent; // возвращаемся к значению по умолчанию

Свойство _accProps должно быть объектом. Это означает, что, если объект _accProps не существует, Вы должны создать объект, до определения его свойств.

if (_accProps == undefined) {
  _accProps = new Object();
}
_accProps.name = "My movie";

Пример

Если Вы изменили фото/объект my_mc/ и хотите обновить его описание, Вы можете использовать следующий ActionScript код :

my_mc.gotoAndStop(2);

if (my_mc._accProps == undefined ) {
  my_mc._accProps = new Object();
}
my_mc._accProps.name = "Photo of Mount Rushmore";
Accessibility.updateProperties();

См.также

Accessibility.isActive(), Accessibility.updateProperties(), System.capabilities.hasAccessibility

Посмотреть комментарии LiveDocs		Предыдущая | Следующая | Оглавление